Inside Macintosh: Programming With the Text Encoding Conversion Manager /

Chapter 3 - Text Encoding Converter Reference / Text Encoding Converter Functions

Investigating Encodings /

TECClearSnifferContextInfo

Resets a sniffer object to its initial settings so it can be reused.

pascal OSStatus TECClearSnifferContextInfo (
                     TECSnifferObjectRef encodingSniffer);

encodingSniffer

A pointer to the sniffer object you want to reuse.

function result

A result code. See "Text Encoding Conversion Manager Result Codes" (page 42) for a list of possible values. If this function returns a result code other than noErr, then one of the conversion plug-ins accessed by the converter encountered an error condition.

DISCUSSION

Sniffers maintain state information about the input encoding buffer and the number of errors and features found for each encoding; this information allows a caller to progressively sniff an input buffer in sequential chunks. Before sniffing a buffer than contains completely new information you must clear any state information by calling TECClearSnifferContextInfo.

SEE ALSO

The function TECCountAvailableSniffers (page 83)

The function TECGetAvailableSniffers (page 84)

The function TECCreateSniffer (page 85)

The function TECSniffTextEncoding (page 86)

The function TECDisposeSniffer (page 89)